home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / libsphere.z / libsphere
Encoding:
Text File  |  2002-10-03  |  6.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. LLLLIIIIBBBBSSSSPPPPHHHHEEEERRRREEEE((((3333LLLL))))                                                    LLLLIIIIBBBBSSSSPPPPHHHHEEEERRRREEEE((((3333LLLL))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      lllliiiibbbbsssspppphhhheeeerrrreeee - the Sphere Library
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ggggllll////ffffsssspppphhhheeeerrrreeee....hhhh>>>>
  13.  
  14.           iiiinnnnttttggggeeeerrrr****4444 ffffuuuunnnnccccttttiiiioooonnnn sssspppphhhhddddrrrraaaa((((ppppaaaarrrraaaammmmssss))))
  15.           rrrreeeeaaaallll ppppaaaarrrraaaammmmssss((((4444))));;;;
  16.  
  17.           iiiinnnntttteeeeggggeeeerrrr****4444 sssspppphhhhggggnnnnpppp(((())))
  18.  
  19.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhhffffrrrreeee(((())))
  20.  
  21.           iiiinnnntttteeeeggggeeeerrrr****4444 ffffuuuunnnnccccttttiiiioooonnnn sssspppphhhhmmmmooooddddeeee((((aaaattttttttrrrriiiibbbbuuuutttteeee,,,, vvvvaaaalllluuuueeee))))
  22.           iiiinnnntttteeeeggggeeeerrrr****4444 aaaattttttttrrrriiiibbbbuuuutttteeee,,,, vvvvaaaalllluuuueeee;;;;
  23.  
  24.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhhoooobbbbjjjj((((oooobbbbjjjjiiiidddd))))
  25.           iiiinnnntttteeeeggggeeeerrrr****4444 oooobbbbjjjjiiiidddd;;;;
  26.  
  27.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhhrrrrmmmmaaaa((((mmmmaaaatttt))))
  28.           rrrreeeeaaaallll mmmmaaaatttt((((4444,,,,4444))));;;;
  29.  
  30.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhhbbbbbbbbpppp((((vvvvooooiiiidddd))))
  31.  
  32.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhheeeebbbbpppp((((vvvvooooiiiidddd))))
  33.  
  34.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssspppphhhhccccllllrrrr((((ccccllllrrrr))))
  35.           rrrreeeeaaaallll ccccllllrrrr((((4444))));;;;
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      The Sphere Library renders spheres by issuing GL calls.  sssspppphhhhddddrrrraaaa draws a
  39.      sphere.  sssspppphhhhmmmmoooodddd sets various attributes that affect the speed and quality
  40.      of spheres rendered by sssspppphhhhddddrrrraaaa. sssspppphhhhrrrrmmmmaaaa allows you to control the
  41.      orientation of spheres by providing a rotation matrix.  sssspppphhhhggggnnnnpppp returns
  42.      the number of polygons per sphere, in the mode currently selected by
  43.      sssspppphhhhmmmmoooodddd.  sssspppphhhhoooobbbbjjjj  operates like sssspppphhhhddddrrrraaaa, except that, instead of
  44.      immediately rendering a sphere, it creates and returns a GL object, which
  45.      can be rendered using ccccaaaalllllllloooobbbb.  The routines sssspppphhhhbbbbbbbbpppp and sssspppphhhheeeebbbbpppp are for
  46.      drawing collections of spheres using a special bitmap image of a phong-
  47.      shaded sphere.  The diffuse color of the bitmap spheres are set with the
  48.      routine sssspppphhhhccccllllrrrr.
  49.  
  50. UUUUSSSSAAAAGGGGEEEE
  51.      To link a program with libsphere, specify ----llllsssspppphhhheeeerrrreeee on the compile line.
  52.      When linking a program with libsphere, you must also specify the Graphics
  53.      Library, ----llllffffggggllll ----llllggggllll____ssss, and the Math Library, ----llllmmmm.
  54.  
  55. CCCCAAAAVVVVEEEEAAAATTTT
  56.      In the current implementation, the Sphere Library maintains an internal
  57.      cache of GL objects, one for each combination of sphere attributes for
  58.      which sssspppphhhhddddrrrraaaa or sssspppphhhhoooobbbbjjjj has been called.  The first call to sssspppphhhhddddrrrraaaa, or
  59.      sssspppphhhhoooobbbbjjjj, with a combination of attributes that has not yet been rendered
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLIIIIBBBBSSSSPPPPHHHHEEEERRRREEEE((((3333LLLL))))                                                    LLLLIIIIBBBBSSSSPPPPHHHHEEEERRRREEEE((((3333LLLL))))
  71.  
  72.  
  73.  
  74.      will result in the creation of a new GL object and, thus, will take
  75.      longer than subsequent calls with the same combination of sphere
  76.      attributes.
  77.  
  78.      If your program uses the Sphere Library and also manipulates its own GL
  79.      objects, you must be careful that your allocation of object identifiers
  80.      does not conflict with the Sphere Library's allocation of object
  81.      identifiers for its internal cache.  The Sphere Library calls ggggeeeennnnoooobbbbjjjj for
  82.      its object identifier allocation.  If your program allocates object
  83.      identifiers for its own use, you should either use ggggeeeennnnoooobbbbjjjj to allocate
  84.      object identifiers or use iiiissssoooobbbbjjjj to verify that any object identifiers
  85.      your program generates are not already being used by the Sphere Library.
  86.      See _m_a_k_e_o_b(3g) and _g_e_n_o_b_j(3g) for further discussion of object
  87.      identifiers.
  88.  
  89.      If you need to free the virtual memory used by the Sphere Library's
  90.      internal cache, you can call sssspppphhhhffffrrrreeee to free all its GL objects and their
  91.      associated memory.
  92.  
  93. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.      sphdra, sphgnp, sphfre, sphmod, sphobj, sphrma, sphbbp, sphebp, sphclr
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.